Network Vulnerability Scanner - Installation Guide
===============================================

QUICK START
-----------

System Requirements
------------------
- OS: Windows 10/11 (64-bit)
- RAM: 4GB minimum, 8GB recommended
- Storage: 2GB free space
- Network: Internet connection
- Permissions: Administrator privileges required

Prerequisites
------------

1. Python (3.8+)
   - Check: python --version
   - If not installed: Download from python.org

2. Npcap (Required)
   - Download from npcap.com
   - Run installer as Administrator
   - Restart computer after installation

3. Administrator Privileges
   - Required for port scanning and Nmap functionality

INSTALLATION METHODS
--------------------

Method 1: Automated (Recommended)
--------------------------------
1. Download and extract the scanner package
2. Navigate to Code folder
3. Right-click setup_scanner.bat (located in the Code folder)
4. Select "Run as administrator"
5. Wait for completion - browser opens automatically

Method 2: Manual
----------------
1. Open Command Prompt as Administrator
2. Navigate to Code directory:
   cd C:\Networkscanner000\Code
3. Install dependencies:
   pip install -r requirements.txt
4. Run application:
   python app.py
5. Open browser to http://127.0.0.1:5000

CONFIGURATION
-------------

Basic Settings
--------------
Default ports in app.py:
COMMON_PORTS = [21, 22, 23, 25, 53, 80, 110, 139, 143, 443, 445, 3389, 3306, 8080, 5900, 1723, 8000, 8443]

Flask settings:
app.run(debug=True, host='127.0.0.1', port=5000)

Customization
-------------
- Add ports: Edit COMMON_PORTS in app.py
- Change target: Modify default target in app.py
- Scan options: Edit arguments in scanner.py

TROUBLESHOOTING
---------------

Common Issues
-------------
Issue: "Nmap not found"
Solution: Install Npcap, run as Administrator

Issue: "Permission denied"
Solution: Run as Administrator

Issue: Port 80/443 not scanning
Solution: Run as Administrator

Issue: Web interface not loading
Solution: Check Python/Flask, try different port

Issue: CVE lookup failing
Solution: Check internet connectivity

Debug Mode
----------
In app.py, add:
app.run(debug=True)

SECURITY GUIDELINES
-------------------

Legal Requirements
-----------------
- Only scan authorized targets
- Obtain permission before scanning
- Document authorization
- Follow local laws and regulations

Best Practices
-------------
- Start with test targets (scanme.nmap.org)
- Use appropriate scan intensity
- Monitor network impact
- Secure scan results

SUPPORT
-------

Getting Help
-----------
1. Check troubleshooting section
2. Review console output
3. Test with scanme.nmap.org
4. Ensure Administrator privileges

Documentation
------------
- User Manual: User_Manual.txt
- API Documentation: See code comments
- Configuration: This document

---

Version: 1.0
Last Updated: January 2025
Compatibility: Windows 10/11, Python 3.8+
License: Educational Use Only 